home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
bbsdoors
/
s_line16.zip
/
S_LINE.DOC
< prev
next >
Wrap
Text File
|
1993-02-23
|
16KB
|
344 lines
┌▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄┐
├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
────────┤▌ G A M E K E E P E R D O O R W A R E ▐├────────
├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
├▌▒▒▒▒▒▒▒▒▒ Quality BBS Door Software for Less! ▒▒▒▒▒▒▒▒▐┤
├▌▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▐┤
└▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀┘
T H E S P O R T S L I N E P O O L D O O R
~~~~~ ~~~~~~~~~~~ ~~~~~~~ ~~~~~~~ ~~~~~~~
Version 1.6
Copyright (c) Steve Sharpe 1992,1993
SYSTEM REQUIREMENTS
~~~~~~~~~~~~~~~~~~~
Any BBS capable of producing the following DOOR.SYS drop files:
* Original "GAP standard" DOOR.SYS (31 line version)
- for example, Spitfire BBSs use this one!
* New (currently 52 line) version DOOR.SYS promoted by Raymond Clements
- for example, PCBoard BBSs use this one!
The Sports Line Pool Door can be played using ANSI color or monochrome
graphics.
SYSTEM OPTIONS
~~~~~~~~~~~~~~
The Sports Line Pool Door supports the use of FOSSIL drivers and non-standard
port addresses. Refer to the INSTALLATION instructions for more information.
FILES CONTAINED IN S_LINE16.ZIP
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
S_LINE16.EXE <-- The main program
S_LINE.DOC <-- The file you are reading!
GAME.CFG <-- The game configuration file
POOL.CFG <-- The pool configuration file
FREEZE.EXE <-- The program to freeze (lock) the door for update
1.DAT <-- Sample team data file (replace with your own)
2.DAT <-- " " " "
3.DAT <-- " " " "
REVISION.DOC <-- Revision notes
DOORWARE.DOC <-- Gamekeeper Doorware
FILES CREATED BY S_LINE16.EXE
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
*.USR <-- Sequential user data files beginning with 0.
WIN.FIL <-- File containing win/loss/tie results for each period.
TOP_PICK.FIL <-- File containing the top picks for each period.
OVERVIEW
~~~~~~~~
The Sports Line Pool Door is a multi-player BBS door designed to promote
friendly competition between players as they strive to accurately determine
which competing sports teams will win, lose, or tie their games. The door
comes complete with built-in title graphics for 4 pools (Football, Baseball,
Basketball, and Generic). It tracks games by periods, starting with 1. A
period represents games played on a given date. The SysOp can load up to 15
competing teams for each period. Players select which teams they think will
win, lose, or tie their opponents. At some point before the games are played,
the door is locked from further access. After the game results for the period
are known, the SysOp (or a designated player) must update the pool. After
each update, the period advances so that new picks can be made. The door
calculates the players with the highest percentage of correct picks for each
period and stores the data in a Top Picks file that can be viewed from the
Main Menu. Players can also review all previously completed periods. The
registered version of the door also creates a Pickmaster display that
shows the players with the highest percentage of correct picks for all
periods. The Pickmaster display is shown as the player exits the door.
INSTALLATION
~~~~~~~~~~~~
The Sports Line Pool Door is easy to install. Simply follow these steps:
1. 'Unzip' the file S_LINE16.ZIP into the directory of your choice. All files
must remain in the same directory.
2. Edit the POOL.CFG and GAME.CFG configuration files according to the
CONFIGURATION FILES section of these instructions using your favorite word
processor. Ensure you save them as ASCII text files.
3. Create sports team data files using the example from the TEAM DATA FILES
section of these instructions. Each data file is saved in ASCII text format
with a 'DAT' file extension. For example, the filename for period 1 teams
will be 1.DAT and the filename for period 2 teams will be 2.DAT, etc.
4. Create or edit the batch file your BBS will use to activate the door.
The main door program name is S_LINE16.EXE. For example, if you are running
a Spitfire BBS, you would edit SF.BAT to look similar to the following:
:DOOR_A
REM Place Door A Commands Here
CD\SF\DOORS\POOL <-- Change to The Sports Line directory
S_LINE16 GAME.CFG <-- The main program with configuration file argument
CD\SF <-- Change back to the Spitfire directory
GOTO LOOP
NON-STANDARD PORT USE: You may specify the use of non-standard communications
ports with the PORT command. The syntax for the PORT command is PORT:03E8:5,
where 03E8 represents a different base address and 5 indicates the IRQ. For
example, the main program line in the example above would be changed to
S_LINE16 GAME.CFG PORT:03E8:5 to reflect the use of a non-standard comm port.
FOSSIL DRIVER USE: You may specify the use of a FOSSIL driver with the PORT
command added to the main program command line. The syntax for the PORT
command is PORT:F:P, where F instructs the door to use a FOSSIL driver and P
identifies the port. For example, the main program line in the example above
would be changed to S_LINE16 GAME.CFG PORT:F:1 if the SysOp wished to specify
a FOSSIL driver on port 1.
NOTE: The PORT command must be the third command in the main program command
line, if used. If not used, the door defaults to the use of the 4 standard
communications ports (1-4) by reading the BBS file.
5. Determine when you want the pool to be locked, awaiting update. For
example, if you are running a football pool that covers Sunday games, you
would most likely leave the door unlocked until Saturday night. At a given
time, the FREEZE.EXE program would be executed to automatically lock the pool.
Sometime on Monday, the user who is responsible for updating the pool would
call and enter win/loss/tie data. The pool would automatically unlock until
the following Saturday night. The FREEZE.EXE program is normally run as a BBS
event. The following event batch file example is for SF.BAT (Spitfire):
:EVENT_B
REM Football Pool Freeze
CD\SF\DOORS\POOL <-- Change to the pool directory
FREEZE <-- Run FREEZE.EXE to freeze (lock) the pool
CD\SF <-- Change back to the BBS directory
GOTO LOOP
CONFIGURATION FILES
~~~~~~~~~~~~~~~~~~~
The entries in the POOL.CFG and GAME.CFG files must be accurate or the door
cannot be expected to function properly. Save your changes to the .CFG files
in ASCII text format.
The GAME.CFG file
~~~~~~~~~~~~~~~~~
The Sports Line Pool Door <-- Line 1 (See below)
c:\sf\door.sys <-- Line 2 " "
The Gamekeeper's Lair <-- Line 3 " "
Steve Sharpe <-- Line 4 " "
000000000000 <-- Line 5 " "
1 <-- Line 6 " "
Line 1 - This line reflects the name of the door. The registration algorithm
is based on some of this data. DO NOT CHANGE LINE 1!
Line 2 - Enter the full path and filename for the BBS DOOR.SYS file.
Line 3 - Enter the name of your BBS.
Line 4 - Enter the SysOp's name.
Line 5 - Enter 12 zeros if the door is not registered. Registered users enter
the registration number provided by the author. Other numbers will prevent
the door from running.
Line 6 - Enter 1 if your BBS DOOR.SYS drop file is the original GAP standard
31 line version. Enter 2 if your BBS DOOR.SYS drop file is the newer (longer)
version (presently 52 lines).
The POOL.CFG file
~~~~~~~~~~~~~~~~~
U <-- Line 1 (See below)
1 <-- Line 2 " "
Sysop <-- Line 3 " "
F <-- Line 4 " "
Line 1 - This line reflects the current pool status and must be set to U to
unlock the pool for use. If the SysOp desires to manually lock the pool, set
line 1 to L. The door will automatically change the pool status to W
(waiting for update) when FREEZE.EXE is run (normally as an event). After the
update, the door will automatically unlock the pool for use again. When the
last period has been reached, the door will set line 1 to C to indicate the
season is complete.
Line 2 - This line reflects the current period. Always start a new pool with
1. The door will automatically advance this number after each update.
Line 3 - Enter the name of the user (exactly as the BBS user record reflects)
who will be responsible for updating the pool. All other users will be locked
out while the pool status is W (waiting for update) until this person logs on
and provides the door with win/loss/tie results for the period.
Line 4 - This line controls the title graphics and internal game headings.
Enter F for Football Pool, B for Baseball Pool, H for Basketball Pool, or any
other single character for the Generic Pool.
TEAM DATA FILES
~~~~~~~~~~~~~~~
The team data files are ASCII text files that must follow a simple but strict
format. The first line always contains the date the games will be played.
This is the period date. The lines that follow are the teams themselves. The
away team is identified first, followed by the home team. The teams are
separated by a comma. For example, the first 3 lines of a football pool data
file should look like:
SEPTEMBER 15, 1992
San Diego Chargers,Miami Dolphins
Chicago Bears,Minnesota Vikings
The resulting screen display from inside the door would read:
San Diego Chargers at Miami Dolphins
Chicago Bears at Minnesota Vikings
The file would be saved as 1.DAT (for period 1), etc. Refer to the 3 sample
.DAT files provided. THE FOLLOWING LIMITATIONS APPLY: Each team name cannot
exceed 21 characters in length and there cannot be more than 15 teams in any
one period file (16 lines including the date). DAT files must always start
with 1 and additional DAT files must be in numeric sequence (if a number is
skipped, the pool will indicate the season is over!).
SEASON'S OVER/RESET
~~~~~~~~~~~~~~~~~~~
At the end of the season, the door can be left in C status indefinitely so
that users can use the Review and Top Pick options within the door. To reset
the door for a new season or a different pool, follow these steps:
1. Delete all .FIL, .DAT, and .USR files.
2. Create new team data (.DAT) files.
3. Edit the POOL.CFG file, as described previously, to begin the new pool
with period 1.
SYSOP KEYS
~~~~~~~~~~
The following keys assist the SysOp in the management of the door:
F5 - Shell to DOS
F8 - Return user to system
F9 - Toggle display on/off
F10 - Chat mode (ESC to exit)
ALT H - Toggle between status lines
REGISTRATION
~~~~~~~~~~~~
The registration fee for The Sports Line Pool Door is $5. The unregistered
door displays "EVALUATION COPY" upon entry and exit. Please register or
remove the door within 90 days of first use. As a BBS SysOp, I understand how
costly it can be to register BBS software. I have purposely kept the cost of
registering The Sports Line Pool Door to a minimum with that thought in mind.
I believe the fee is quite reasonable, based on the many long hours of
programming required. Upon receipt of the registration fee, you will be
provided with a unique registration number. Once you insert the registration
number into the GAME.CFG file, the opening and closing "EVALUATION COPY"
messages will be replaced with the following messages:
[OPENING MESSAGE]
Your BBS name
presents
[CLOSING MESSAGE]
Thanks for playing
The Sports Line Pool Door
on
Your BBS name
COMMENTS/BUG REPORTS
~~~~~~~~~~~~~~~~~~~~
I'm interested in all user comments and bug reports. Please send your comments
to:
Steve Sharpe Call The Gamekeeper's Lair BBS
1835 Stonetree Dr. or (208) 587-1105
Mountain Home, ID 83647 and leave a message
Warranty
------------
This program has been thoroughly tested on a Spitfire 3.2 BBS,
however, it should perform equally well on any BBS that can
produce a BBS drop file listed in this documentation.
I make no warranty of any kind, express or implied, including
without limitation, any warranties of merchantability and/or
fitness for a particular purpose. I shall not be held liable for
any damages, whether direct, indirect, special or consequential
arising from a failure of this program to operate in the manner
desired by the user. I shall not be held liable for any damage to
data or property which may be caused directly or indirectly by the
use of this program.
In no event will I be held liable for any damages, including (but
not limited to) any lost profits, lost savings or other incidental
or consequential damages arising out of the use or inability to
use this program, or for any claim by any other party.
This warranty is governed by the laws of the State of Idaho.
REGISTRATION FORM
-----------------
The Sports Line Pool Door Return to: Steve Sharpe
Version 1.6 Attn: Door Registration
Registration Cost: $5 1835 Stonetree Dr.
Mountain Home, ID 83647
Name ______________________________________________________________
Address ___________________________________________________________
___________________________________________________________
Voice Phone _____________________ Data Phone ______________________
Enter GAME.CFG file information below:
BBS Name______________________________________________
SysOp Name____________________________________________
CHOOSE ONE OPTION BELOW:
____ I wish to download my registration number from The Gamekeeper's Lair
BBS at (208) 587-1105. Enter the password you will use to log on to
The Gamekeeper's Lair BBS: _________________________________________
Enter your birthdate for pre-verification: _________________________
Please allow enough time for your registration fee to reach the author
before calling for your registration number.
____ I wish to have my registration number mailed to the address listed
above.
Orders outside the USA add $2.00 . . . . . . . . . . . . _________
Please find enclosed a check or money order for USA $_________
payable to Steve Sharpe. This shows my support of Shareware products
and the Shareware concept. It also shows my encouragement to help further
the development of BBS doors.
I understand that The Sports Line Pool Door is provided as-is and no
warranties of any kind, expressed or otherwise, are included and that I am
using it at my own risk.
Signed: _________________________________________ Date: _________